15.0.0

Commander 15 is ESM only. This is expected to be seamless for ESM consumers, but some CommonJS consumers may hit issues with tooling requiring configuration for ESM-only dependencies. See Migration Tips below.

The release of Commander 15 moves Commander 14 into maintenance. Commander 14 will get security updates for
12 months (to May 2027). For more info see Release Policy.

Added

• show excess command-arguments in error message (#2384)

Fixed

• Breaking: only lone --no-* option sets default option value to true, default not implicitly set when define both positive and negative option in either order (#2405)
• update example to use compatible character for MINGW64 (#2475)

Changed

• Breaking: migrated Commander implementation from CommonJS to ESM (#2464)
• Breaking: Commander 15 requires Node.js v22.12.0 or higher (for require(esm)).
• dev: switch tests from Jest to node:test test runner (#2463)

Deleted

• Breaking: removed deprecated export of commander/esm.mjs (#2464)

Migration Tips

Commander 15 is ESM only, but this does not mean you need to migrate to ESM to use it. Importing ESM from CommonJS is
supported by Node.js, and Bun, and Deno. Hopefully it Just Works for you! However, you may be using a different runtime or
some other part of your setup that may not yet natively support importing ESM from CommonJS, such as your testing framework
or bundler.

If you have problems using Commander 15 in your environment, one option is stay on Commander 14 for now. Commander 14 will
get security updates until May 2027 and things will hopefully improve for your setup in the meantime.

Does any of this look wrong? Please let us know.

See the full diff on Github. The new version differs by 22 commits:

• Fix release dates in changelog (#2523)
• Pin GitHub actions with hash (#2521)
• Drop EOL node 20 from test matrix, and add node 26 (#2520)
• Update details for 15.0.0 release (#2519)
• Remove jest esm examples (#2517)
• Update dependencies (#2518)
• Update dependencies (#2506)
• Use node:util stripVTControlCharacters instead of own code (#2486)
• Use simple match in test (to avoid warning about expensive regex) (#2485)
• Update dependecies and lint (#2489)
• Use prerelease version so example can work before release (#2488)
• Update changelog and version and engine for prerelease (#2484)
• Merge from develop into release/15.x (with minor conflicts and test migrations)
• Switching to esm-only (#2464)
• Merge from develop (#2482)
• Modernise tsconfig targets, and add .cjs (#2481)
• fix(examples): use dash separator to avoid MINGW64 path expansion (#2475)
• Bump prettier from 3.7.4 to 3.8.1 (#2476)
• Bump @types/node from 22.19.1 to 22.19.7 (#2477)
• Bump globals from 16.5.0 to 17.3.0 (#2478)
• Bump typescript-eslint from 8.48.0 to 8.54.0 (#2479)
• Bump eslint-plugin-jest from 29.2.1 to 29.12.1 (#2480)

@​depfu rebase

Rebases against your default branch and redoes this update

@​depfu recreate

Recreates this PR, overwriting any edits that you've made to it

@​depfu merge

Merges this PR once your tests are passing and conflicts are resolved

@​depfu cancel merge

Cancels automatic merging of this PR

@​depfu close

Closes this PR and deletes the branch

@​depfu reopen

Restores the branch and reopens this PR (if it's closed)

@​depfu pause

Ignores all future updates for this dependency and closes this PR

@​depfu pause [minor|major]

Ignores all future minor/major updates for this dependency and closes this PR

@​depfu resume

Future versions of this dependency will create PRs again (leaves this PR as is)